home *** CD-ROM | disk | FTP | other *** search
/ United Public Domain Gold 2 / United Public Domain Gold 2.iso / utilities / pu065.dms / pu065.adf / IconiSer / Iconiser.DOC < prev    next >
Text File  |  1988-12-08  |  5KB  |  127 lines
  1.  
  2.                              ICONISER
  3.  
  4.                         By Michael Saunby
  5.  
  6. INTRODUCTION
  7.  
  8. Features
  9. Iconiser generates icons for invisible files so they may be moved, copied, 
  10. duplicated, or discarded from the workbench without executing a single CLI 
  11. command.
  12. Iconiser can discard an icon without discarding the file, making the file 
  13. visible.
  14. Iconiser runs from the Workbench or the CLI.
  15. Iconiser does not enable copies to be made of copy protected disks, indeed 
  16. Iconiser should never be used on any original disk.
  17.  
  18. Requirements 
  19. Iconiser requires Workbench 1.2. Iconiser accesses the icon library on the
  20. Workbench disk so you may be asked to insert the Workbench disk when you
  21. start Iconiser. This is the only time the Workbench disk is needed so when
  22. the disk lamp goes out it may be removed.
  23.  
  24. WARNINGS 
  25. Iconiser uses RAM: the ram disk device. If RAM: is not already open 
  26. Iconiser will open it, consequently you may notice a small decrease in 
  27. available memory.
  28. For some programs it will be possible to run them as workbench tools. 
  29. Others such as the CLI commands on the Workbench disk cannot be run in 
  30. this way, though it is usually possible to use a program such as Xicon to 
  31. run them. See the iconiser options section before using Iconiser to 
  32. create icons for programs to be run from the Workbench 
  33.  
  34. HOW TO USE ICONISER 
  35. Iconiser is simple to use. Click once on Iconiser, press and hold a 
  36. shift key and then click twice on the disk to which you wish to add 
  37. icons. If the disk was already open, close it, then open again to 
  38. reveal any new icons. If the disk was closed, open it to reveal the 
  39. icons.
  40.  
  41. If you have only one disk drive, Iconiser is easier to use if copied 
  42. to RAM: the ram disk device.
  43.  
  44. Multiple selection.
  45. Multiple selection may be used with Iconiser. Click once on Iconiser, 
  46. hold a shift key and click once on each drawer or disk to be processed 
  47. except the last. Click twice on the last disk or drawer.
  48.  
  49. Removing icons with Iconiser.
  50. To remove the icon from a tool or project, click once on Iconiser, hold 
  51. a shift key and click twice on the icon to be removed. A requester will 
  52. appear at the top left corner of the screen; it looks like this:
  53.  
  54.  
  55.          --------------------------------------- 
  56.         |System Request ====================[][]|
  57.         |---------------------------------------|
  58.         | Discard icon "myprog"                 |
  59.         | Warning: you cannot get               |
  60.         | back what you discard                 |
  61.         |                                       |
  62.         | ---------------          ------------ |
  63.         |  ok to discard            forget it!  |
  64.         | ---------------          ------------ |
  65.          ---------------------------------------
  66.  
  67. To remove the icon click on 'ok to discard', to cancel click on 
  68. 'forget it!'. Multiple selection can be used when removing icons, the 
  69. requester will appear for each file.
  70. To remove the icon from a drawer requires Iconisers delete mode to be 
  71. switched on. This is done by entering the following text into iconisers 
  72. tool types:
  73. DELMODE=ON
  74.  
  75. Iconiser options
  76. In addition to DELMODE there are two other modes which can be set. They
  77. are set using the IFFTYPES and TOOLTYPE options.For projects there is 
  78. the IFFTYPES option, this is used to set a default tool for IFF files. 
  79. eg
  80. IFFTYPES=ILBM ILBM=:ShowILBM
  81.  
  82. Other possible options are SMUS or FTXT or any other ILBM FORM. A vertical
  83. bar should be used to separate types. eg
  84. IFFTYPES=ILBM|FTXT
  85. ILBM=Workbench:ShowILBM 
  86. FTXT=:ShowText 
  87.  
  88. For tools there is the TOOLTYPE option, this determines whether an icon is 
  89. created for the tool itself or for a script file to be executed by another 
  90. program eg Xicon.
  91. TOOLTYPE=PROJECT   or     TOOLTYPE=TOOL
  92. TOOLNAME=C:XICON
  93. TOOLTEXT=(NAME) argument
  94.  
  95. The variable (NAME) can be used in the TOOLTEXT argument; (NAME) will be 
  96. replaced by the name of the program. After any substitution has been made 
  97. the text is written to a file with the name of the program with the 
  98. character '-' appended. A project type icon is  created for this file.
  99.  
  100. Summary of options 
  101. DELMODE=ON  or  DELMODE=OFF  default is OFF
  102. IFFTYPES=ILBM|FTXT  default no IFF types set
  103. ILBM={path1}{prog1}
  104. FTXT={path2}{prog2} 
  105. TOOLTYPE=PROJECT  or  TOOLTYPE=TOOL  default is TOOL
  106. TOOLNAME={path}{prog}  no default, if not set TOOLTYPE defaults to
  107.                                         TOOL 
  108. TOOLTEXT=(NAME) no default, if not set TOOLTYPE defaults to TOOL
  109.  
  110. nb case is important in tool types entries.
  111.  
  112. ERROR MESSAGES
  113. Iconiser uses requesters to indicate various errors such as write 
  114. protected disks or incorrect usage. Click on one of the "ok" boxes to 
  115. remove the requester and continue.
  116.  
  117. CLI USAGE
  118. Iconiser will create icons when used from the CLI, none of the options can
  119. be used. The CLI usage is:
  120. ICONISER dirname
  121. Where dirname is the name of the  directory or drive. An alternative usage 
  122. for single drive machines is:
  123. ICONISER ?
  124. iconiser will prompt with
  125. DIR:
  126. now swap the disk and type df0: or df0:dirname.
  127.